PRELIMINARY DOCUMENTATION 


APF IMl1 EDITOR 


The Editor is used to create source code files in MC6800 mnemonic. The 
source file can then be used by the Assembler. 


Editor Function Keys 


The Editor Program makes use of the top row of the main keyboard to 
implement a full screen editor. : 


Using the HERE IS as an "ALT MODE" shift and simultaneously pressing any 
of the other 12 keys on the top row allows the following functions: 


INS DEL DEL oe MSS 
PAGE END XMIT LINE LINE HOME Chak 2 Caan + a: - 
1 2 3 4 > 6 7 8 ) 0 2 >: ABRE 


The 4 arrows will move the cursor up, down, left, or right. 


INS CHAR - Including the character in the cursor location, all characters 
of the line are moved right one place with a black character 
inserted in the current cursor position. 

DEL CHAR - The character in the cursor position is deleted, and all char- 
acters of the line move left one place. ; 

HOME - Brings the cursor to the top left corner. 

DEL LINE - Deletes the line the cursor is on and moves the rest of the lines 
of the page up one row. A blank line is inserted on the bottom 
of the page. 

INS LINE - Inserts a blank line below the line where the cursor is. All 
subsequent lines are. shifted down one row. 

XMIT - Used to page forward or display the next page of the source 
listing. 

PAGE - Used to page backward or display the previous page of source 
listing. 

END - Used to indicate entry of source code is completed. 


To Use The Editor 


1 Place the diskette with the Editor in Drive 0. If using two drives, place 


source diskette (with old source or blank and formatted) in Drive l. Bd 


using only one drive, the source will be placed 
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in Drive 0, after the Editor is loaded. 

Load the Editor by typing RUN "EDITOR" and Return. 

Start the Editor by typing RUN again. 

Enter the file name you want. If it is an existing file on 
the source diskette, it will be brought into memory. If it 

is a new file, disk space will be opened for it. Type up to 

7 characters for the name. If less than 7, press Return Key 
after name is typed. 

Next, enter a 0 or 1 for which drive the source diskette is in. 


Type Y or N as to whether you are editing from memory. 


The cursor will now return to the file name field. You can 
change the file name. 


To end this entry, press XMIT (HERE IS and 3 Key). If the 
file name existed, its first page will be displayed. Sw age By 
is a new file, then a blank screen is shown. 


Entering Source Code 


There are 4 main types of fields or items that can be entered on 
a source line. 


Symbols - A symbol or label starts in the first column of a line. 


It can be arbitrarily long, but the Assembler will use 
only the first 3 characters and the last character in 
its symbol table, so they must be unique. 


Verb - Standard Motorola MC6800 verbs or instruction code 


mnemonics are used. The verb goes in the 2nd field. 
If it is preceded by a label, you need 1 space between 
the end of the label and the verb. If the line has 

no label, then the verb must start in Column 2 or 
greater. 


Operand - The Operand Field follows the Verb Field. There must 


be 1 space between the end of the verb and the operand. 


Comments - Comments can be placed in 2 places after the Operand 


Field (and preceded by 1 space), or if the first char- 
acter of a line is an *, the whole line is treated as 
a comment. ‘ 


ea 
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Operator Field 


1 - The valid Operators include the 72 executable instructions 
of the MC6800 plus the following assembler directive. 


ORG - Directs the Assembler to change the program counter to have 
a value as specified in the Operand Field. 


EQU - Sets the label to have a value as specified in the Operand 
Field. If an asterick is used in the Operand Field, the 
present value of the program counter is assigned to the 
label. 

Ex: LAl EQU- $0100 
ORG $A400 
BEG EQU * 


FCB - Form constant byte. Multiple bytes can be entered by 
separating with commas. 


FDB - Form double byte. 


FCC - Form constant character. The Operand Field has the # of 
characters, a comma, then the text. 


RMB - Reserve memory bytes. 


END - Must be the last statement in a program. 


Operands 


1. Can be absolute value in hexadecimal or decimal. Hex is 
preceded by $ symbol. 


$0400 - Hexadecimal (maximum number isS$FFFF) 
0400 - Decimal (maximum number in decimal is 9999) 


2. Can be a symbol whose value will be used. 


3. Can be an expression combining number, and/or symbols. Expres- 
sions can contain plus or minus signs and will be processed. 


Addressing Modes 


1. Direct or extended are resolved by the Assembler. 


2. To indicate immediate mode, precede the Operand by a # symbol. 
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Completing the Editor Program 


When source code is finished being entered or changed, press 
HERE IS and the 2 Key (END) to finish. 


Again you are asked for file name and drive. You may change the 
file name from the previous one entered, in which case the pre- 
vious source code is saved as was, and a new source file is opened. 
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THE ASSEMBLER 


The assembler is a single pass assembler that converts a source 
program to assembled code. 


Load "ASMBLR" 


If you want a printout (and have a printer connected), after 
loading the asmblr type PRINT = 1. Then start the asmbler by 
typing RUN. 


First you will be asked for the out file name. This is the file 
name to be assigned to the outputted assembled code. Ee tae 
output goes to Drive 0, type the name, then the Return Key. If 
it is to go on Drive 1, type the name, : (colon), and l. 


Next you are asked the in file name (the name of the source). 
Type it in, and similarly a Return Key, or :1l as above. 


The assembled listing will be either displayed on tne screen or 
on a printer. It will be displayed as follows: 


ADDRESS BYTE 1, BYTE 2, BYTE 3, SOURCE CODE 


Since this is a one-pass assembler, any forward referenced 
symbols are not resolved until they are encountered. When they 
are encountered, the previous references are displayed and 
printed with the code generated. 


At the end of the assembly, a list of any unresolved labels is 
shown and you are asked if you want a symbol sort or symbol 
table. 


Error Messages 


Error A - Verb does not start with an alphabetic character. A 
verb is an operation code or pseudooperation of the 
assembly language. This error can result from a prior 
error, or from mistyping source data. 


Error B - Verb not in table. This is the primary indication of 
an invalid mnemonic operation code. 


Error C - Verb does not allow immediate addressing. An attempt 
was made to use immediate addressing (signified by a 
'#' character immediately preceding the operand) with 
an operation that has no immediate mode. For example, 


ASR #OOPS 


would generate this message. 


5 
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Error D - Invalid verb modifier. 


Error E - Symbol table overflow. This is a terminal error, in 
the sense that code following a symbol table overflow 
can have spurious errors. To recover, the program 
being assembled should be partitioned so that a smaller 
number of symbols is required in assembling each part. 
Note that the capacity of Tiny Assembler 6800 is 200 
symbols in this version. 


Error F - Label already in use. The following are several sets 
of duplicate labels (as interpreted by Tiny Assembler 
6800): 


In Label Field In Symbol Table 


THINKS 
THIS THIS 
THIMBLES 


AOUTI1X 
AOUT2X AOUX 
AOUT3X 


While symbols can be arbitrarily long, the first three 
characters and last character must be unique. 


Error G - Relative branch greater than 128 locations away. This 
error occurs if the target of a branch instruction is 
too far away for a signed 8 bit displacement from the 
present location counter value. This can usually be 
fixed by using a jump instruction. For example, if 


BMI TARG 
he 
gives error G, then it might*replaced by the comple- 
mentary condition and a jump as follows 


BPL DUM1L 
JMP TARG 
DUM1 *** continue code ae* 


Error H - Forward reference table full. This is a warning 
message that indicates imminent collapse of an assembly 
if another reference to an undefined symbol is found 
prior to the resolution of any previously unresolved 
reference. Tiny Assembler 6800 has a table of 25 
unresolved forward references maximum. 
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Brtoxr i 


EVror- J 


Error K 


Forward reference table overflow. This is the terminal 
message that indicates an attempt to exceed 25 unre- 
solved forward references. After this error is noted, 
there will typically be numerous spurious error messages. 
Eliminate forward references to undefined labels to 

cure this problem. One way to eliminate an unresolved 
forward reference is to define the data or code involved 
prior to its first reference. 


Invalid character in hexadecimal or decimal number. 
Only two types of numeric constant are allowed by 

Tiny Assembler 6800: up to four decimal aLgqits,. ora 
dollar sign ($) character followed by up to four hexa- 
decimal digits. 


Invalid symbol. A symbol in the label field of an 
operation begins with a number, or an invalid character 
is detected in a symbol. 


